home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro46 / curset.txt < prev    next >
Encoding:
Text File  |  1993-10-25  |  9.7 KB  |  238 lines
  1. CUREDIT, CURSET Version 3.5, (C) Copyright 1993 Mike Heilemann
  2.  
  3.        Programmed by Mike Heilemann
  4.  
  5.  
  6. 1.1
  7.  
  8. DEFINITION:
  9.  
  10. CURSOR SET (CURSET.EXE) is a TSR program which takes less than 10K of memory.
  11. The function of this program is to transform the dull blinking DOS cursor to 
  12. a lively animated one.  CURSET is especially usefull on Laptop or computer 
  13. systems with LCDs or similar displays.  As many people have found, it is 
  14. very easy to lose the normal underscore cursor.  CURSET banishes this problem
  15. forever!
  16.  
  17. Curset performs it's magic by dynamically re-mapping one of the standard ASCII
  18. characters with your predefined animation frames.  By cycling through the 
  19. frames many times per second it achieves the illusion of smooth animation.  
  20. (Just like a cartoon!)
  21.  
  22. There are a few limitations that you need to be aware of when you use curset.
  23. Fortunately, most computer systems out there today fall outside the bounds of
  24. these limits.  Requires a 286 or better system with an EGA or VGA video adapter 
  25. to run CURSET.
  26.  
  27. A single ASCII text character is really just a 16 x 8 block of pixels. (8x8
  28. pixels in 43/50 line mode)  Each row of 8 pixels is refered as a SCAN LINE.  EGA
  29. and VGA cards will allow a clever programmer to re-define some or all of these
  30. characters, and replace them with another pattern.  CURSET redefines one of the 
  31. 255 different ASCII characters every second.  This character is then used for 
  32. your cursor!
  33.  
  34. 1.2
  35.  
  36. COMPATIBILITY:
  37.  
  38. Hardware/Software Requirements:
  39.  
  40. - A 286 or better CPU (recommended)
  41. - EGA or VGA video card and monitor
  42. - MS-DOS 3.1 or higher.
  43.  
  44. Software Compatability:
  45.  
  46.  
  47. 4DOS, NDOS, DRDOS 6.0, DESQVIEW, Stacker 2.0+, QEMM 6.0+, OS/2 2.0 VDM and
  48. should be compatible with most other software.
  49.  
  50. CURSET may be loaded high memory with QEMM, 386-MAX, DOS 5.0 & 6.0  EMM386, and 
  51. OS/2 VDM. Other memory managers have not been tested, but I see no reason why 
  52. they would not also work.
  53.  
  54. Windows sometimes has problems remapping characters.  CURSET detects and
  55. disables itself when Windows 3.0/3.1 is loaded.  The problem is that when
  56. a "windowed" DOS session is switched to full screen mode, the display could be
  57. garbled.
  58.  
  59. OS/2 has no such problem, and CURSET works when switching from Windowed to Full
  60. Screen.  Please note that if you do switch from a Full Screen to Windowed DOS
  61. session, the cursor will be disabled until you switch back.
  62.  
  63. If you find that a particular application has problems with CURSET, you can
  64. easily create a batch file to disable CURSET and run the app.  The batch file
  65. can then re-enable CURSET after the program has terminated.  Example:
  66.  
  67.     @ECHO OFF
  68.     CURSET /OFF
  69.     PROGNAME.EXE  REM This is your bad application...
  70.     CURSET /ON
  71.  
  72.  
  73. Some programs such as Norton Utilites, PC Tools, and others use the same
  74. character remapping technique as CURSET to make their programs have more of a
  75. graphical look and feel.  If such programs remap the same ASCII character as
  76. CURSET (which defaults to 255), you may wish to change the character that CURSET
  77. uses.  Character number 05 should be a good alternative.  To load CURSET with an
  78. alternate remap character, use the following command line:
  79.  
  80.     CURSET /005
  81.  
  82. Any character from 000 to 255 can be used after the '/'.  Please note that you 
  83. can only change the character during initial startup of CURSET.  You can NOT 
  84. change the remap character while curset is loaded.  To get around this, do 
  85. the following:
  86.  
  87.     CURSET /U         <-- Uninstall CURSET
  88.     MODE CO80         <-- Reset video card, and EGA/VGA character set
  89.     CURSET /###       <-- Load CURSET with the new remap character
  90.  
  91.  
  92. 1.3
  93.  
  94. COMMAND LINE USAGE:
  95.  
  96. CURSET </###> </C:##> </NOINV> </ON | /OFF> </UNINSTALL> <FILENAME>
  97.  
  98. Current function of switches:
  99.  
  100. /###     - Set remap character (0-255) Default is 255
  101. /C:##    - Set foreground cursor color from 1 - 15
  102. /NOINV   - Disable inversion of cursor upon detection of a solid block cursor
  103. /ON      - Enable cursor
  104. /OFF     - Disable cursor
  105. /U       - Removes program from memory if possible
  106. FILENAME - Read in cursor file filename
  107.  
  108. You can choose a different remap character with the /### command where ###
  109. is the decimal value (from 0 - 255) of the ASCII character you wish to remap.
  110.  
  111. Setting the color of the cursor will set the foreground color only.  CURSET
  112. leaves the background color totally alone.  If no color is specified, it will
  113. keep the forground color of whatever character it is on.  If a foreground
  114. color is specified, and it happens to be the same as the background color,
  115. CURSET will use the old foreground color.
  116.  
  117. The /NOINV will make it so CURSET's cursor will NOT invert.  In this mode it
  118. will always animate unless it is turned off or hidden by some program.  CURSET
  119. normally inverts the cursor when it is turned into a solid block.  Actually
  120. it inverts it when the cursor is set over 6 scan lines.
  121.  
  122. If CURSET is unable to uninstall itself, that indicates that some other TSR
  123. has been loaded after it.  If this is the case, CURSET will remain in operation
  124. IE. the cursor will remain animated.  In order to uninstall it you will first
  125. have to unload all the other TSR programs that have been loaded after CURSET.
  126. Though you may use the /OFF switch to disable CURSET.
  127.  
  128. CURSET changes the keyboard repeat rate, so that the timer can keep up with
  129. the output to the screen.  The rate CURSET changes it to is faster than the
  130. normal repeat rate (17.1 characters per second) as opposed to the normal 10.0
  131. characters per second).  If this rate is changed by another program, in some
  132. instances the remap character can be left on the screen during scrolling.
  133.  
  134.  
  135.  
  136. 1.4  DESIGNING YOUR OWN CURSORS
  137.  
  138.  
  139. FILENAME is the name of the cursor file you wish to use for CURSET's animated
  140. cursor.  The format for such a file is:
  141.  
  142.     1                     BYTE  - number of frames from 1 to 10.
  143.     16 * number of frames BYTES - value of 16 scan line cursor.
  144.     8  * number of frames BYTES - value of 8 scan line cursor.
  145.  
  146. Each scan line is made up of a byte, with each bit determining if the 
  147. corresponding pixel is on or off.  For example, here is one frame of an 8 scan
  148. line cursor:
  149.  
  150.     *______*  81 Hex  129 Dec
  151.     *__**__*  99 Hex  153 Dec
  152.     **_**_**  DA Hex  218 Dec
  153.     _**__**_  66 Hex  102 Dec
  154.     _**__**_  66 Hex  102 Dec
  155.     **_**_**  DA Hex  218 Dec
  156.     *__**__*  99 Hex  153 Dec
  157.     *______*  81 Hex  129 Dec
  158.  
  159. The file must contain the numeric values, not an ASCII value.  Remember that you
  160. also need to create a 16 and an 8 scan line cursor for the cursor to show up 
  161. properly in all text modes. 
  162.  
  163. This conversion process is pretty long and tedious for making cursors, so when
  164. you REGISTER your copy, you will receive CUREDIT, which allows you to make
  165. your own cursors with minimal effort, using the keyboard or mouse.  It also
  166. allows you to edit cursors, and see the animation sequence.
  167.  
  168.  
  169.  
  170. 1.5
  171.  
  172. HOW IT WORKS:
  173.  
  174. CURSET works by remapping a video character constantly cycling through the
  175. animation sequence.  The remappable character can be defined by the user with
  176. the /### switch upon initial startup (see the above command line switches).
  177. This may cause a slight problem with some applications that display special
  178. characters.  If they display the character you are remapping on the screen,
  179. it will be animated instead of the character they ment to display.  The default
  180. remap character is 255 which is a blank unused character, so the only problems
  181. you should see are in programs which use and remap this character, in HEX
  182. dumps, or executables and the like.
  183.  
  184. CURSET also gets requests to change the cursor and handles them in its own way.
  185. No matter what request to change the cursor comes in, we disable the cursor,
  186. but we do handle 3 different cases: turning the cursor off, turning the cursor
  187. on, and making the cursor a full or almost full block.  The only difference
  188. you are likely to see is when the cursor is a block, in this case, we invert
  189. our animating cursor.  This is usefull when in applications that use a block
  190. cursor to indicate a special cursor mode, such as insert.
  191.  
  192.  
  193.  
  194.  
  195. CURSOR EDIT (CUREDIT.EXE) NOTES:
  196.  
  197. CUREDIT will be sent to you when you register your copy of CURSET.  It allows
  198. you to make custom cursors of your own design quickly and easlily.  Mouse and
  199. Keyboard are both supported.  Frame copying, frame shifting, in editor
  200. animation, 16 and 8 scan line cursor editing on the same screen are all part
  201. of CUREDIT!.  It will also detect if curset is loaded, and disable the curset
  202. cursor, which makes it easier to see what you are editing.  You can edit a
  203. cursor and save it out with a new name, allowing for veriations on cursors.
  204. Scrolling cursors are now a snap with the new commands to move frames up,
  205. down, left and right.  More documentation will be provided on the disk after
  206. registration of CURSET.  Please fill out and send in the registration form if
  207. you are interested.
  208.  
  209.  
  210.   <A>nimate goes through 6 repititions of the animation sequence.  It also
  211. cycles the top remap characters.
  212.  
  213.   <C>opy makes a copy of the frame and places it in the next frame. Upon
  214. copying a frame, will move you to that frame if you are currently on the last
  215. frame.
  216.  
  217.   <U>p rolls the current frame up one scan line, moving the image up.
  218.  
  219.   <D>own rolls the current frame down one scan line, moving the image down.
  220.  
  221.   <L>eft rolls the current frame to the right.
  222.  
  223.   <R>ight rolls the current frame to the right.
  224.  
  225.   <X> Clears current frame.
  226.  
  227.   The HOME key puts you at the top left of whatever cursor you are working on
  228.  
  229.   The END key places you at the lower right.
  230.  
  231.   All cursor keys, will wrap to the opposite side of the screen.
  232.  
  233.   Page up and down will also wrap from first to last, or last to first.
  234.  
  235.   <TAB> moves you from the 16 line to the 8 line cursor and vice versa.
  236.  
  237.   <?> Displays help screen
  238.